home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / RELEASE.NOTES < prev   
Text File  |  1995-07-26  |  8KB  |  180 lines
  1.  
  2. Release and Install Notes - SCO Skunkware 5
  3. =======================================
  4.  
  5. To Get Started
  6. --------------
  7.  
  8. On an SCO OpenServer Release 5 system :
  9.  
  10. # mkdir /usr/skunk
  11. # mount -r -f RCKRDG /dev/cd0 /usr/skunk
  12. # /usr/skunk/bin/spray
  13.  
  14. If, as root, you are running the X.Desktop, then you can configure your
  15. system to mount the SCO Skunkware 5 CD-ROM by double-clicking the System
  16. Administration folder -> Filesystems -> Filesystem Manager. Alternatively,
  17. at a root shell prompt, type "scoadmin f" to bring up the Filesystem Manager.
  18. Next select Mount -> Add Mount Configuration -> Local and enter /dev/cd0 for 
  19. the device and /usr/skunk for the mount point. Change the "Can Users to Mount" 
  20. to Yes and uncheck the "At System Startup" mount. After completing this 
  21. operation, you should be able to mount and unmount the SCO Skunkware 5 CD-ROM 
  22. by typing "mnt /usr/skunk" and "umnt /usr/skunk" as any user.
  23.  
  24. NOTE TO SCO ODT 3.0 USERS :
  25.  
  26.     The Rockridge extensions to the High-Sierra filesystem format are not
  27.     supported under SCO ODT 3.0. In order to mount the SCO Skunkware 5 CD-ROM
  28.     on an ODT 3.0 system, use the command :
  29.  
  30.         # mount -r -f HS,lower /dev/cd0 /usr/skunk
  31.  
  32.     All filenames will be mapped to lower case and truncated to a maximum of
  33.     8 characters with a 3 character suffix (i.e. 8.3 file naming as in MS-DOS).
  34.     Although the ELF binary format and use of DLLs prevents execution on ODT 3.0
  35.     systems, you will still be able to read and copy files to your system (e.g.
  36.     you may want to apply one or more of the Technical Level Supplements in 
  37.     /usr/skunk/tls to your ODT 3.0 system).
  38.     
  39. On any other system, after mounting or otherwise making the High-Sierra
  40. Rockridge CD-ROM filesystem accessible, point your WWW browser to
  41. <mount-point>/lib/X11/Mosaic/index.html where <mount-point> indicates
  42. the UNIX directory or Windows drive representing the CD-ROM.
  43.  
  44. What is it ?
  45. ------------
  46.  
  47. The software on this volume has been built primarily using the
  48. SCO OpenServer Development System Release 5.  In most cases, we
  49. have built binaries intended for the SCO OpenServer Release 5
  50. family of products, using ELF binaries and Dynamic Link
  51. Libraries.  Some of the programs will run on earlier versions,
  52. but these have not been extensively tested.  In many cases,
  53. source code is also provided, so you can rebuild for earlier SCO
  54. releases or other platforms.
  55.  
  56. This cdrom is built as a mountable filesystem, and may be mounted
  57. to view, use, or install.  To mount the cdrom, use the mount(ADM)
  58. command with the mount point of your choice.  We suggest using a
  59. mount point of /usr/skunk:
  60.  
  61.       # mount -r -f RCKRDG /dev/cd0 /usr/skunk
  62.  
  63. In order to take full advantage of the SCO Skunkware 5 applications,
  64. you will need to add <mount-point>/bin and <mount-point>/bin/X11
  65. to your PATH.  For example, if you're using the Bourne Shell or
  66. Korn Shell:
  67.  
  68.       PATH=$PATH:/usr/skunk/bin:/usr/skunk/bin/X11
  69.       export PATH
  70.  
  71. In addition, to play the audio portions of this distribution you will
  72. need to have installed the Network Audio System and Voxware soundcard
  73. drivers. See the README in the /usr/skunk/tls directory for more info.
  74.  
  75. Some packages may assume /usr/local as their install directory.
  76. For those cases, symbolic links will need to be created in order
  77. to run some of the software directly from the cd-rom, with no
  78. modifications.  Obviously, those packages (such as some games)
  79. that write into their directories will have to be moved to your
  80. hard drive to execute.
  81.  
  82. We have provided a shell script which will create the necessary
  83. symbolic links on your system.  Once the cd-rom is mounted,
  84. execute the "spray" shell script.  The syntax for the spray
  85. script is "spray [mount-point]" where [mount-point] is an
  86. optional argument indicating the full directory path where you've
  87. got the cd mounted.  If no argument is present, spray assumes you
  88. have the cd mounted on /usr/skunk.
  89.  
  90.         # PATH=$PATH:<mount-point>/bin
  91.         # spray <mount-point>
  92.  
  93. Or, if you don't want to add the Skunkworks bin directory to root's PATH,
  94.         # <mount-point>/bin/spray <mount-point>
  95.  
  96. Where <mount-point> refers to the full path of the cd-rom mount point.
  97. The spray shell script is readable and writeable by root. If you would
  98. prefer to create the symbolic links by hand or create only a portion of
  99. them, read the script to determine what needs to be done.
  100.  
  101. If you did not choose to do so during the running of spray, you can perform
  102. additional Skunkware configuration that requires copying files to the hard
  103. drive and setting permission and ownership correctly by running the command :
  104.  
  105.         # /usr/skunk/bin/sprinkle
  106.  
  107. If you would prefer to copy only a few of the files and directories, then
  108. edit this script to move/chmod only the ones you want.
  109.  
  110. Note also that some of the programs here require that they run in
  111. suid or guid privileged execution.  These binaries do NOT have
  112. suid or guid execution privileges set.  The sprinkle script
  113. will handle the task of moving and chmod of SCO Skunkware files.
  114.  
  115. After running spray and (optionally) sprinkle, you are ready to use you
  116. SCO Skunkware 5.0 CD-ROM. We have provided an extensive collection of
  117. HTML documents to assist you in gaining familiarity with the SCO Skunkware 5
  118. contents. To browse the contents, issue the command :
  119.  
  120.         # /usr/skunk/bin/prowl
  121.  
  122. You may also want to modify the MANPATH setting in
  123. /etc/default/man in order to easily access the (many) man pages
  124. provided.  To do this, add <mount-point>/man to MANPATH.  For
  125. example, if you mounted the cd-rom on /usr/skunk, then edit
  126. /etc/default/man to set the MANPATH as :
  127.  
  128.         MANPATH=scohelp:/usr/man:/usr/skunk/man
  129.  
  130. The MANPATH can also be set as a shell environment variable. For
  131. instance, using the Bourne or Korn shells:
  132.  
  133.         $ MANPATH=scohelp:/usr/man:/usr/skunk/man
  134.         $ export MANPATH
  135.  
  136. Source code is provided in the /src directory.  The packages
  137. appear as subdirectories under /src/Tools, /src/X11 and
  138. /src/Games.  In some cases, source code is provided but no
  139. compiled binaries. Several source directories contain a gzip'd tar archive
  140. of the source. In order to extract these, cd to a writeable empty directory
  141. and use the command :
  142.  
  143.     $ /usr/skunk/bin/gzcat /usr/skunk/src/<directory>/<file>.tar.gz | tar xf -
  144.  
  145. Also contained in the cd-rom filesystem layout are the /tls and
  146. /cdmt directories.  The /tls directory contains SCO Technical
  147. Library Supplements which you may find of interest.  These are
  148. drawn from the SCO Support Online System, and are also accessible
  149. via anonymous ftp on the Internet from ftp.sco.com, or via
  150. web facilities at http://www.sco.com
  151.  
  152. The /cdmt directory contains custom(ADM) installable disk images.
  153. To install the custom portion of SCO Skunkware 5, issue the following 
  154. command as root :
  155.  
  156.     cd /usr/skunk/cdmt; make install
  157.     
  158. or 
  159.  
  160.     custom -p SKUNK:default -L -z /usr/skunk/cdmt/archives/TAPE
  161.     custom -p SKUNK:default -e
  162.     
  163. If you do not have enough room to install the entire SKUNK SSO, you may 
  164. install one or more packages via custom interactive. Start custom, 
  165. select :
  166.     Software->Install New->From local host->Media Images 
  167.  
  168. then type in "/usr/skunk/cdmt/archives/TAPE"
  169.  
  170. Neither the /tls or /cdmt directories contain software which may be executed 
  171. from the mounted cd-rom.  Some of the software located there is replicated
  172. in the cd-rom filesystem and may be executed there.
  173.  
  174. We are interested in your general comments about this distribution
  175. and about development tools in general.    Please direct to:
  176.  
  177. Dion L. Johnson II  - The Santa Cruz Operation, Inc.              dionj@sco.com
  178. SCO Product Manager - Development Systems and Advanced Hardware Strategy
  179. 400 Encinal St.  Santa Cruz, CA 95061    FAX: 408-427-5417  Voice: 408-427-7565
  180.